home *** CD-ROM | disk | FTP | other *** search
/ Commodore 64 Scene Diskmags Assortment / Commodore_CEE_Vol._1_Issue_05_1995_Jack_Vander_White_Disk_1_of_3_Side_A.d64 / reply doc 1 < prev    next >
Text File  |  2023-02-26  |  11KB  |  220 lines
  1.  TEXT EDITOR VERSION 2.9
  2.  
  3.  Creating a document
  4.  
  5.  To start the text editor, just LOAD and RUN as you would any basic pogram.
  6.  Although this editor is written in machine language, it starts up with the
  7.  aid of a basic starting shell for ease of operation and copying.
  8.  
  9.  Text memory will be cleared automatically, and your margins will be preset to
  10.  5 left, 75 right and 55 lines per page.
  11.  
  12.  You can also manually clear the text buffer by selecting 1 (from the editor's
  13.  menu) and pressing RETURN. You will be asked to confirm the command (just a
  14.  safety precaution for those like myself who sometimes forget to save things
  15.  before erasing them).
  16.  
  17.  If you wish to set up the margins and page length, use selection 2. Default
  18.  values are: left margin 5, right 75, lines per page, 55. The current value
  19.  will be displayed under the cursor, giving you a chance to either modify the
  20.  value or leave it intact (just pressing RETURN will use the current value).
  21.  
  22.  Now enter the edit mode with selection 3 (default menu selection). If you
  23.  ever get a ?FORMAT ERROR message, it will probably be because the text buffer
  24.  needs to be initialized or the margins were set to illegal values (left > 77
  25.  or too close to right or right > 80).
  26.  
  27.  
  28.  NOTE: You can return to the menu at any time by pressing the STOP key. Also,
  29.  pressing CTRL H (while in edit mode) will return a help screen to assist
  30.  those who don't like to memorize control and function keys.
  31.  
  32.  
  33.  The screen will clear and (if you used the default margin values) you will
  34.  see bars at the left and right sides of your screen. These are the margin
  35.  markers, and at the bottom of the screen will be a status line. You will not
  36.  be able to type into the margin markers, as they are there to help you format
  37.  your text and let you know where your lines start and end. All screen lines
  38.  will be combined in pairs as 80 column lines, which will leave you with 12
  39.  lines on the screen at a time. You can identify which page, line and column
  40.  the cursor is on by reading the status line at the bottom of the screen. The
  41.  status line also tells you which mode you are in (40 or 80 column). Default
  42.  mode is 80 column. 40 column mode can be invoked with CTRL X, for those who
  43.  prefer to work with 40 column text (best for creating source code files or
  44.  creating messages in 40 column format (non-standard text files).
  45.  
  46.  Type a line of text. At the end of the line, press RETURN to get to the next
  47.  line, or just keep on typing. Words will not be broken at the right margin
  48.  marker, because of the editor's automatic PARSING feature. If the last letter
  49.  on a line is not a space, the editor will move the entire word to the next
  50.  line for you. There are some safety features built into this routine, too. If
  51.  there is text on the next line, parsing will not take place. This allows you
  52.  to edit a previous line without accidentally dumping text on the next one.
  53.  Also, parsing will not operate on words longer than 10 characters. That was
  54.  done to allow the use of long strings of dashes for borders, etc. Parsing is
  55.  there to allow you to type without having to watch the screen. Be wary of
  56.  shifted spaces...the editor treats them as characters (not spaces), and they
  57.  can cause unexpected results, especially if they are on the next line...the
  58.  editor will not parse, thinking there is text there. This can be used to
  59.  FORCE a word to stay on the previous line, should you want it to.
  60.  
  61.  CURSOR KEYS
  62.  
  63.  Cursor right and left work as you would expect them to. Cursor up and down
  64.  are a bit different. They move the cursor 2 screen lines at a time (which is
  65.  really ONE 80 column line). The insert and delete keys will work as expected,
  66.  but only on the current line. When holding the delete key down, the cursor
  67.  will make it's way only as far as the left margin. If you want to delete part
  68.  of the previous line, move the cursor there with a cursor left, and then
  69.  continue deleting. The insert key will push all text from the cursor position
  70.  on towards the right margin. Text pushed into the right margin cannot be
  71.  recovered. The home key works normally, but screen clear is not supported.
  72.  
  73.  SCROLLING THE SCREEN AND THE TEXT BUFFER
  74.  
  75.  Attempting to move the cursor past the bottom of the screen will cause the
  76.  screen to scroll forward. Reverse scrolling will happen at the top of the
  77.  screen. When you move the cursor to the end of available memory, forward
  78.  movement will stop. The same is true for reverse movement at the screen's
  79.  top.
  80.  
  81.  THE CTRL KEYS
  82.  
  83.  CTRL D will delete the current line and draw all forward lines in to close
  84.  the gap. CTRL I will open up a blank line, pushing all lines forward from the
  85.  current line on. Holding CTRL d or CTRL i will allow you to quickly delete or
  86.  insert large portions of text. Even faster inserts and deletes are possible
  87.  with the next set of keys (BLOCK CTRL KEYS).
  88.  
  89.  THE BLOCK CTRL KEYS
  90.  
  91.  These keys call routines which operate on a BLOCK of text (a block being one
  92.  or more full lines of text). The first time a BLOCK CTRL key is pressed, the
  93.  start of the block is defined and stored (it will be the line the cursor is
  94.  on), and the cursor fast-flashes to let you know you have invoked a BLOCK
  95.  function. The second time you press the BLOCK CTRL key, you should have
  96.  already moved the cursor to the line you wish to designate as the last line
  97.  in the block. That line will be defined as the end of the block, and the
  98.  function will then be executed.
  99.  
  100.  
  101.  NOTE: If you accidentally invoke a block function (the cursor will fast-flash
  102.  when one is started), you can cancel it by pressing the STOP key. This will
  103.  take you to the menu (where all editing functions are cancelled), and from
  104.  there you can return to edit mode by pressing RETURN (selection 3 will be
  105.  under the cursor).
  106.  
  107.  CTRL A (align a block)
  108.  
  109.  This command will "repack" a block of text between the margin markers. I
  110.  frequently use it to convert 40-column text captured by my terminal's buffer
  111.  to 80 columns for printing. Blank lines are preserved, but all extra spaces
  112.  between words are eliminated (repacks with one space between words). If extra
  113.  spaces between words are desired, use shifted spaces (they're treated like a
  114.  character by the alignment routine). Here's an alignment demo:
  115.  
  116.  
  117.  This is the first line.
  118.  This is the second line.
  119.  This is the third line.
  120.  
  121.  
  122.  Now here are the same 3 lines repacked with CTRL A:
  123.  
  124.  
  125.  This is the first line. This is the second line. This is the third line.
  126.  
  127.  
  128.  Here's the set of lines repacked to be an indented block of text:
  129.  
  130.  
  131.                This is the first line.
  132.                This is the second line.
  133.                This is the third line.
  134.  
  135.  The first repack was done by pressing CTRL A with the cursor on the first
  136.  line. Then, CTRL A on the last line. The block gets copied and repacked in a
  137.  buffer, the original block removed, and the new "repacked" block inserted in
  138.  it's place. The block buffer retains a copy of the last block buffered.
  139.  
  140.  The second repack was done with the margins reset to 15 left and 40 right. If
  141.  you try this last one yourself, you will notice that the margin markers will
  142.  cover up some of the text when you reenter edit mode (normal). Just go ahead
  143.  and define the block with CTRL A's. Then reset the margins after the repack.
  144.  
  145.  CTRL C (copy a block)
  146.  
  147.  This function copies a block of text into the block buffer.
  148.  
  149.  CTRL M (merge or insert a block)
  150.  
  151.  Inserts the text from the block buffer into the document at the cursor line.
  152.  Text from the cursor line on is moved forward in the document to make room
  153.  for the merger.
  154.  
  155.  CTRL R (remove a block)
  156.  
  157.  Removes a block of text from the document and closes up the gap. The removed
  158.  block is copied into the block buffer. This function can be used to delete
  159.  huge portions of text, or to "pick up" a piece of the document, relocate and
  160.  merge it elsewhere with a subsequent CTRL M.
  161.  
  162.  CTRL R can also be used to buffer a chunk of your document so that you can
  163.  load another one and merge the buffered text into it. Here's how:
  164.  
  165.  Gobble up the portion of your document you DON'T want with CTRL R. Last,
  166.  gobble the text you WANT. This will leave you with a blank workspace, and
  167.  the desired text in the block buffer. Now, load the file you want to merge
  168.  the text into, and insert the buffered text with CTRL M.
  169.  
  170.  Sounds like the long way around, but if you clear your workspace from the
  171.  menu, you also clear the block buffer. So, CTRL R will give you a way to do
  172.  it. You can also merge text with the load routine (see that section).
  173.  
  174.  CTRL J (justify lines in block)
  175.  
  176.  Allows you to right-justify the lines in a block of text.  Extra  spaces  are
  177.  inserted between words until the last character in the line rests  one  space
  178.  to the left of the right margin. The printing routine will also right-justify
  179.  text, but it operates on the entire document. CTRL J allows  you  to  justify
  180.  smaller parts of it only, if that is what you wish to do. An example is  this
  181.  paragraph, and the next one:
  182.  
  183.  This is  an  indented  block  of  text
  184.  aligned on the  screen  with  a  right
  185.  margin  of  40...then  it  was   right
  186.  justified, and  the  original  margins
  187.  restored. Note  the  "blocked"  effect
  188.  when  you  print   these   paragraphs.
  189.  
  190.  CTRL S (set block underlining)
  191.  
  192.  You can define any text to be underlined by typing it in reverse video (more
  193.  on this later). CTRL S will convert an entire block to a reverse video block.
  194.  When the editor's printing routine comes across this text, it will be sent to
  195.  the printer as underlined text (as long as the printer has that capability).
  196.  This function, and CTRL K, will allow you to define less than a full line of
  197.  text as part of the block. The text does not get copied into the buffer.
  198.  Also, CTRL S will not underline spaces at the end of a line, and will ignore
  199.  blank lines.
  200.  
  201.  CTRL K (kill block underlining)
  202.  
  203.  Kills any reverse video in a block of text. Sometimes you may load a file and
  204.  find it full of reverse video text (nulls added to a file by a BBS can cause
  205.  this to happen. More on this later). When that happens, this function will
  206.  allow you to correct it very quickly.
  207.  
  208.  CTRL V (view the block buffer)
  209.  
  210.  Allows you to see what's in the block buffer. Will not function if the buffer
  211.  is empty.
  212.  
  213.  CTRL Z (zero block buffer)
  214.  
  215.  Allows you to zero the block buffer. You may want to do this if you run out
  216.  of memory (and you have text in the block buffer) and you need to free up
  217.  some extra room for the rest of your document. As you may have guessed, the
  218.  block buffer is allocated from part of the "free" text buffer.
  219.  
  220.